<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD><TITLE>ttk::panedwindow manual page - Tk Themed Widget</TITLE>
<link rel="stylesheet" href="../docs.css" type="text/css" media="all">
</HEAD>
<BODY><H2><a href="../contents.htm">Tcl8.6.11/Tk8.6.11 Documentation</a> <small>&gt;</small> <a href="contents.htm">Tk Commands</a> <small>&gt;</small> ttk_panedwindow</H2>
<H3><A HREF="../UserCmd/contents.htm">Tcl/Tk Applications</A> | <A HREF="../TclCmd/contents.htm">Tcl Commands</A> | <A HREF="../TkCmd/contents.htm">Tk Commands</A> | <A HREF="../ItclCmd/contents.htm">[incr Tcl] Package Commands</A> | <A HREF="../SqliteCmd/contents.htm">SQLite3 Package Commands</A> | <A HREF="../TdbcCmd/contents.htm">TDBC Package Commands</A> | <A HREF="../TdbcmysqlCmd/contents.htm">tdbc::mysql Package Commands</A> | <A HREF="../TdbcodbcCmd/contents.htm">tdbc::odbc Package Commands</A> | <A HREF="../TdbcpostgresCmd/contents.htm">tdbc::postgres Package Commands</A> | <A HREF="../TdbcsqliteCmd/contents.htm">tdbc::sqlite3 Package Commands</A> | <A HREF="../ThreadCmd/contents.htm">Thread Package Commands</A> | <A HREF="../TclLib/contents.htm">Tcl C API</A> | <A HREF="../TkLib/contents.htm">Tk C API</A> | <A HREF="../ItclLib/contents.htm">[incr Tcl] Package C API</A> | <A HREF="../TdbcLib/contents.htm">TDBC Package C API</A></H3>
<DL>
<DD><A HREF="ttk_panedwindow.htm#M2" NAME="L1992">NAME</A>
<DL><DD>ttk::panedwindow &mdash; Multi-pane container window</DD></DL>
<DD><A HREF="ttk_panedwindow.htm#M3" NAME="L1993">SYNOPSIS</A>
<DL>
</DL>
<DD><A HREF="ttk_panedwindow.htm#M4" NAME="L1994">DESCRIPTION</A>
<DD><A HREF="ttk_panedwindow.htm#M5" NAME="L1995">STANDARD OPTIONS</A>
<DL>
<DD><A HREF="ttk_widget.htm#M-class">-class, undefined, undefined</A>
<DD><A HREF="ttk_widget.htm#M-cursor">-cursor, cursor, Cursor</A>
<DD><A HREF="ttk_widget.htm#M-style">-style, style, Style</A>
<DD><A HREF="ttk_widget.htm#M-takefocus">-takefocus, takeFocus, TakeFocus</A>
</DL>
<DD><A HREF="ttk_panedwindow.htm#M6" NAME="L1996">WIDGET-SPECIFIC OPTIONS</A>
<DL>
<DD><A HREF="ttk_panedwindow.htm#M7" NAME="L1997">-orient, orient, Orient</A>
<DD><A HREF="ttk_panedwindow.htm#M8" NAME="L1998">-width, width, Width</A>
<DD><A HREF="ttk_panedwindow.htm#M9" NAME="L1999">-height, height, Height</A>
</DL>
<DD><A HREF="ttk_panedwindow.htm#M10" NAME="L2000">PANE OPTIONS</A>
<DL>
<DD><A HREF="ttk_panedwindow.htm#M11" NAME="L2001">-weight, weight, Weight</A>
</DL>
<DD><A HREF="ttk_panedwindow.htm#M12" NAME="L2002">WIDGET COMMAND</A>
<DL class="widget command">
<DD><A HREF="ttk_panedwindow.htm#M13" NAME="L2003"><I>pathname </I><B>add </B><I>subwindow options...</I></A>
<DD><A HREF="ttk_panedwindow.htm#M14" NAME="L2004"><I>pathname </I><B>forget </B><I>pane</I></A>
<DD><A HREF="ttk_panedwindow.htm#M15" NAME="L2005"><I>pathname </I><B>identify </B><I>component x y</I></A>
<DL class="widget command">
<DD><A HREF="ttk_panedwindow.htm#M16" NAME="L2006"><I>pathname </I><B>identify element </B><I>x y</I></A>
<DD><A HREF="ttk_panedwindow.htm#M17" NAME="L2007"><I>pathname </I><B>identify sash </B><I>x y</I></A>
</DL>
<DD><A HREF="ttk_panedwindow.htm#M18" NAME="L2008"><I>pathname </I><B>insert </B><I>pos subwindow options...</I></A>
<DD><A HREF="ttk_panedwindow.htm#M19" NAME="L2009"><I>pathname </I><B>pane </B><I>pane -option </I>?<I>value </I>?<I>-option value...</I></A>
<DD><A HREF="ttk_panedwindow.htm#M20" NAME="L2010"><I>pathname </I><B>panes</B></A>
<DD><A HREF="ttk_panedwindow.htm#M21" NAME="L2011"><I>pathname </I><B>sashpos </B><I>index</I> ?<I>newpos</I>?</A>
</DL>
<DD><A HREF="ttk_panedwindow.htm#M22" NAME="L2012">VIRTUAL EVENTS</A>
<DD><A HREF="ttk_panedwindow.htm#M23" NAME="L2013">STYLING OPTIONS</A>
<DD><A HREF="ttk_panedwindow.htm#M24" NAME="L2014">SEE ALSO</A>
</DL>
<H3><A NAME="M2">NAME</A></H3>
ttk::panedwindow &mdash; Multi-pane container window
<H3><A NAME="M3">SYNOPSIS</A></H3>
<B>ttk::panedwindow</B> <I>pathname </I>?<I>options</I>?<BR>
<I>pathname </I><B>add</B> <I>window</I> ?<I>options...</I>?<BR>
<I>pathname </I><B>insert</B> <I>index</I> <I>window</I> ?<I>options...</I>?<BR>
<H3><A NAME="M4">DESCRIPTION</A></H3>
A <B>ttk::panedwindow</B> widget displays a number of subwindows,
stacked either vertically or horizontally.
The user may adjust the relative sizes of the subwindows
by dragging the sash between panes.
<H3><A NAME="M5">STANDARD OPTIONS</A></H3>
<DL>
<DT><B><A HREF="ttk_widget.htm#M-class">-class, undefined, undefined</A></B>
<DT><B><A HREF="ttk_widget.htm#M-cursor">-cursor, cursor, Cursor</A></B>
<DT><B><A HREF="ttk_widget.htm#M-style">-style, style, Style</A></B>
<DT><B><A HREF="ttk_widget.htm#M-takefocus">-takefocus, takeFocus, TakeFocus</A></B>
</DL>
<H3><A NAME="M6">WIDGET-SPECIFIC OPTIONS</A></H3>
<DL>
<DT>Command-Line Name: <B><A NAME="M7">-orient</A></B>
<DT>Database Name: <B>orient</B>
<DT>Database Class: <B>Orient</B>
<DD>Specifies the orientation of the window.
If <B>vertical</B>, subpanes are stacked top-to-bottom;
if <B>horizontal</B>, subpanes are stacked left-to-right.
<P><DT>Command-Line Name: <B><A NAME="M8">-width</A></B>
<DT>Database Name: <B>width</B>
<DT>Database Class: <B>Width</B>
<DD>If present and greater than zero,
specifies the desired width of the widget in pixels.
Otherwise, the requested width is determined by the width
of the managed windows.
<P><DT>Command-Line Name: <B><A NAME="M9">-height</A></B>
<DT>Database Name: <B>height</B>
<DT>Database Class: <B>Height</B>
<DD>If present and greater than zero,
specifies the desired height of the widget in pixels.
Otherwise, the requested height is determined by the height
of the managed windows.
</DL>
<H3><A NAME="M10">PANE OPTIONS</A></H3>
The following options may be specified for each pane:
<DL>
<DT>Command-Line Name: <B><A NAME="M11">-weight</A></B>
<DT>Database Name: <B>weight</B>
<DT>Database Class: <B>Weight</B>
<DD>An integer specifying the relative stretchability of the pane.
When the paned window is resized, the extra space is added
or subtracted to each pane proportionally to its <B>-weight</B>.
</DL>
<H3><A NAME="M12">WIDGET COMMAND</A></H3>
Supports the standard <B>configure</B>, <B>cget</B>, <B>state</B>,
and <B>instate</B> commands; see <I>ttk::widget(n)</I> for details.
Additional commands:
<P>
<DL class="widget command">
<DT><A NAME="M13"><I>pathname </I><B>add </B><I>subwindow options...</I></A><DD>
Adds a new pane to the window.
See <B><A HREF="#M10">PANE OPTIONS</A></B> for the list of available options.
<P><DT><A NAME="M14"><I>pathname </I><B>forget </B><I>pane</I></A><DD>
Removes the specified subpane from the widget.
<I>pane</I> is either an integer index or the name of a managed subwindow.
<P><DT><A NAME="M15"><I>pathname </I><B>identify </B><I>component x y</I></A><DD>
Returns the name of the element under the point given by <I>x</I> and <I>y</I>,
or the empty string if no component is present at that location.
If <I>component</I> is omitted, it defaults to <B>sash</B>.
The following subcommands are supported:
<P>
<DL class="widget command">
<DT><A NAME="M16"><I>pathname </I><B>identify element </B><I>x y</I></A><DD>
Returns the name of the element at the specified location.
<P><DT><A NAME="M17"><I>pathname </I><B>identify sash </B><I>x y</I></A><DD>
Returns the index of the sash at the specified location.
<P></DL>
<P><DT><A NAME="M18"><I>pathname </I><B>insert </B><I>pos subwindow options...</I></A><DD>
Inserts a pane at the specified position.
<I>pos</I> is either the string <B>end</B>, an integer index,
or the name of a managed subwindow.
If <I>subwindow</I> is already managed by the paned window,
moves it to the specified position.
See <B><A HREF="#M10">PANE OPTIONS</A></B> for the list of available options.
<P><DT><A NAME="M19"><I>pathname </I><B>pane </B><I>pane -option </I>?<I>value </I>?<I>-option value...</I></A><DD>
Query or modify the options of the specified <I>pane</I>,
where <I>pane</I> is either an integer index or the name of a managed subwindow.
If no <I>-option</I> is specified, returns a dictionary of the pane
option values.
If one <I>-option</I> is specified, returns the value of that <I>option</I>.
Otherwise, sets the <I>-option</I>s to the corresponding <I>value</I>s.
<P><DT><A NAME="M20"><I>pathname </I><B>panes</B></A><DD>
Returns the list of all windows managed by the widget, in the index order of
their associated panes.
<P><DT><A NAME="M21"><I>pathname </I><B>sashpos </B><I>index</I> ?<I>newpos</I>?</A><DD>
If <I>newpos</I> is specified, sets the position
of sash number <I>index</I>.
May adjust the positions of adjacent sashes
to ensure that positions are monotonically increasing.
Sash positions are further constrained to be between 0
and the total size of the widget.
Returns the new position of sash number <I>index</I>.
<P></DL>
<P>
The panedwindow widget also supports the following generic <B><A HREF="../TkCmd/ttk_widget.htm">ttk::widget</A></B>
widget subcommands (see <I>ttk::widget(n)</I> for details):
<dl><dd><table border="0"><tr><td><p class="tablecell"><B>cget</B><td><p class="tablecell"><B>configure</B><tr><td><p class="tablecell"><B>instate</B><td><p class="tablecell"><B>state</B></table></dl>
<H3><A NAME="M22">VIRTUAL EVENTS</A></H3>
The panedwindow widget generates an <B>&lt;&lt;EnteredChild&gt;&gt;</B> virtual event on
LeaveNotify/NotifyInferior events, because Tk does not execute binding scripts
for &lt;Leave&gt; events when the pointer crosses from a parent to a child. The
panedwindow widget needs to know when that happens.
<H3><A NAME="M23">STYLING OPTIONS</A></H3>
The class name for a <B>ttk::panedwindow</B> is <B>TPanedwindow</B>.  The
sash has a class name of <B>Sash</B>.
<P>
<B>TPanedwindow</B> styling options configurable with <B><A HREF="../TkCmd/ttk_style.htm">ttk::style</A></B>
are:
<P>
<B>-background</B> <I>color</I>
<P>
<B>Sash</B> styling options configurable with <B><A HREF="../TkCmd/ttk_style.htm">ttk::style</A></B>
are:
<P>
<B>-background</B> <I>color</I>
<BR>
<B>-bordercolor</B> <I>color</I>
<BR>
<B>-gripcount</B> <I>count</I>
<BR>
<B>-handlepad</B> <I>amount</I>
<BR>
<B>-handlesize</B> <I>amount</I>
<BR>
<B>-lightcolor</B> <I>color</I>
<BR>
<B>-sashpad</B> <I>amount</I>
<BR>
<B>-sashrelief</B> <I>relief</I>
<BR>
<B>-sashthickness</B> <I>amount</I>
<P>
Some options are only available for specific themes.
<P>
See the <B><A HREF="../TkCmd/ttk_style.htm">ttk::style</A></B> manual page for information on how to configure
ttk styles.
<H3><A NAME="M24">SEE ALSO</A></H3>
<B><A HREF="../TkCmd/ttk_widget.htm">ttk::widget</A></B>, <B><A HREF="../TkCmd/ttk_notebook.htm">ttk::notebook</A></B>, <B><A HREF="../TkCmd/panedwindow.htm">panedwindow</A></B>
<div class="copy">Copyright &copy; 2005 Joe English
</div>
</BODY></HTML>
